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About This Manual 


Objectives of This Manual 

This manual provides reference descriptions of commands available in the Prism 
programming environment 


Intended Audience 

The manual is intended for application programmers using Prism to develop 
programs in C, C*, Fortran, and CM Fortran on a GM-2, CM-200, or CM-5 
Connection Machine system. We assume you know the basics of developing and 
debugging programs, as well as the basics of using a CM Some familiarity with 
the UNIX debugger dbae is useful, but not required. Prism is based on the X and 
OSF/Motif standards. Familiarity with these standards is also helpful but not 
required. 


Revision Information 

This manual has been updated to include changes made in Prism Version 1.2. 


Organization of This Manual 

The manual presents the reference descriptions of the commands in alphabetical 
order. 


Related Documents 

Read the Prism User’s Guide for complete information on how to use Prism. 

Refer to the release notes for last-minute information on Prism. The release notes 
are available on-line by choosing the Release Notes selection from the Help menu. 
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or by issuing the help release command. 


Notation Conventions 


The table below displays the notation conventions observed in this manual. 


Convention 

Meaning 

bold typewriter 

Prism, UNIX, and CMOST commands, command op¬ 
tions, and filenames, when they appear embedded 
in text. Also programming language elements, 
such as keywords, operators, and function names, 
when they appear embedded in text. 

italics 

Placeholders in command synopses. 

% bold typewriter 

regular typewriter 

In interactive examples, user input is shown in 
bold typewriter and system output is shown in 
regular typewriter font 
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Customer Support 


Thinking Machines Customer Support encourages customers to report errors in 
Connection Machine operation and to suggest improvements in our products. 

When reporting an error, please provide as much information as possible to help 
us identify and correct die problem. A code example that failed to execute, a 
session transcript, the record of a backtrace, or other such information can 
greatly reduce the time it takes Thinking Machines to respond to the report 

If your site has an applications engineer or a local site coordinator, please contact 
that person directly for support. Otherwise, please contact Thinking Machines’ 
home office customer support staff: 

Internet 

Electronic Mail: customer-support@th.ink. com 


uucp 

Electronic Mail: ames! think! customer-support 

U.S. Mail: Thinking Machines Corporation 

Customer Support 
245 Erst Street 

Cambridge, Massachusetts 02142-1264 
Telephone: (617) 234-4000 
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Commands Reference 


This reference manual gives, in alphabetical order, the syntax and reference 
description of every Prism command. This information is also available online: 

a Choose the Commands Reference selection from the Help menu to 
obtain reference information about all Prism commands. 

■ Type help commands on the Prism command line to obtain summary 
information about Prism commands. 

■ Type help command-name on the command line to display the reference 
description of the command. 

In the syntax descriptions, text in bold is text that you type on the command line. 
Words in italics are placeholders for which you substitute die appropriate word 
or phrase. 

Table 1 lists die commands discussed in this manual. 


Redirecting Output 

You can redirect the output of most Prism commands to a tile by including an 
at sign (@) followed by the name of die file on the command line. For example, 

where 8 where.output 

puts the output of a where command into the tile where. output, in your cur¬ 
rent working directory within Prism. 
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You can also redirect output of a command to a window by using the syntax on 
window, where window can be: 

■ command (abbreviation com). This sends output to the command window; 
this is the default. 

■ dedicated (abbreviation ded). This sends output to a window dedicated 
to output for this command. If you subsequently issue the same command 
(no matter what its arguments) and specify that output is to be sent to the 
dedicated window, this window will be updated. 

■ snapshot (abbreviation sna). This creates a window that provides a 
snapshot of the output. If you subsequently issue the same command and 
specify that output is to be sent to the snapshot window, Prism creates a 
separate window for the new output. The time each window was created 
is shown in its title. Snapshot windows let you save and compare outputs. 

You can also make up your own name for die window; the name appears in the 
tide of the window. 

The commands whose output you cannot redirect are: cmcoldboot, cmf inger, 
edit, email, make, and sh. 
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Table 1. Prism commands. 


Command 

Use 

/string 

Searches forward in the current file for string. 

tstring 

Searches backward in the current file for string. 

address/ 

Prints the contents of a location in memory. 

value=base 

Converts a value to a different base. 

alias 

Defines an alias. 

assign 

Assigns the value of an expression to a variable or array. 

attach 

Attaches to a running process. 

call 

Calls a procedure or function. 

catch 

Tells Prism to catch the specified signal. 

cd 

Changes the current working directory. 

cmattach* 

Attaches to a CM resource. 

cmcoldboot* 

Cold boots a CM resource. 

cmdetach* 

Detaches from a CM resource. 

cmflnger* 

Displays information about CM users. 

cmsetsafety* 

Sets safety on or off far a CM resource. 

collection 

Turns collection of performance data on or off. 

cont 

Continues execution. 

core 

Associates a core fiQe with an executable program. 

delete 

Removes an event 

detach 

Detaches from a running process. 

display 

Displays the value of an expression. 

doc 

Displays on-line documentation in commands-only Prism. 

down 

Moves the symbol-lookup context down one level. 

dump 

Prints the names and values of variables. 

edit 

Calls up an editor. 

email 

Sends mail about Prism. 

file 

Sets the source file to the specified filename. 

func 

Sets the current function to the specified function name. 

help 

Lists currently implemented commands. 

hide** 

Removes a pane from a split source window. 

ignore 

Tells Prism to ignore the specified signaL 

list 

Lists source lines. 

load 

Loads a program. 

log 

Creates a log file of your commands and Prism’s responses. 

make 

Executes the make utility. 

next 

Executes one or more source lines, stepping over functions. 


* Available from GM-2 and CM-200 front ends only. 
**Not available in commands-only Prism. 
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Table 1. Prism commands (cont’d). 

Command 

Use 

next! 

Executes one or more instructions, stepping over functions. 

perf 

Displays performance data. 

perfadvice 

Displays an analysis of performance data. 

perfload 

Loads a performance data file. 

perfsave 

Saves performance data to a file. 

print 

Prints the value of an expression. 

printenv 

Displays currently set environment variables. 

pushbutton** 

Adds a Prism command to the tear-off region. 

pwd 

Prints the current working directory. 

quit 

Leaves Prism. 

reload 

Reloads the currently loaded program. 

return 

Steps out to die caller of the current routine. 

run 

Starts execution of a program. 

select 

Chooses the master pane in a split source window. 

set 

Defines an abbreviation for a variable or expression. 

setenv 

Displays or sets environment variables. 

show** 

Splits the source window. 

show events 

Prints the event list 

source 

Reads commands from a file. 

status 

Prints the event list. 

step 

Executes one or more source lines. 

stepl 

Executes one or more instructions. 

stepout 

Steps out to the caller of the current routine. 

stop 

Sets a breakpoint. 

stqpl 

Sets a breakpoint at an instruction. 

teaxoff** 

Adds a menu selection to the tear-off region. 

trace 

Traces program execution. 

trace! 

Traces instructions. 

type 

Provides type information on Paris parallel variables. 

unalias 

Removes an alias. 

unset 

Removes an abbreviation created by set. 

unsetenv 

Removes the setting of an environment variable. 

untearoff** 

Removes a button from the tear-off region. 

up 

Moves the symbol-lookup context up one level. 

use 

Adds a directory to the list to be searched for source files. 

whatis 

Prints the type of a variable. 

when 

Sets a breakpoint. 


■ **Not available in commands-only Prism. 
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Table 1. Prism commands (coat’d). 


Command Use 


where Prints a stack trace. 

whereis Prints the list of all fully qualified names for an identifier, 

which Prints the folly qualified name Prism chooses for an identifier. 
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n 


I 

9 

■ 

Searches forward or backward for a text string in the current source rile. 


Synopsis 

/string 

?string 


Description 

Use die / command to search forward in the current source rile for the text string 
you specify. If the string is found, the source pointer moves to the line that con¬ 
tains the string, and the line is echoed in the history region of the command 
window. 

The ? command works in the same way, except that it searches backward in the 
source rile. 

If the text string is not found. Prism displays the message 
no match 
in the history region. 
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address/ 


address/ 

Prints the contents of memory addresses. 


Synopsis 

address, address/[mode] 
address 1 register/ [counf\ [mode] 


Description 

Use these commands to print the contents of memory or a register. If two ad¬ 
dresses are separated by commas, Prism prints the contents of memory starting 
at the first address and continuing up to the second address. If you specify a 
count. Prism prints count locations starting from the address you specify. 

If the address is . (period), Prism prints the address following the one printed 
most recently. 

Specify a symbolic address by preceding the name with an &. For example, 
&x/ 

prints the contents of memory for variable x. 

The address you specify can be an expression made up of other addresses and the 
operators +, and indirection (unary *). For example, 

0x1000+100/ 

prints the contents of the location 100 addresses above address 0x1000. 

Specify a register by preceding its name with a dollar sign. For example, 

$fo/ 

prints the contents of the fO register. See the display or print command far 
a list of supported registers. 
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wmmmm mmm mm m mm 


The mode argument specifies how memory is to be printed; if it is omitted. Prism 
uses the previous mode that you specified. The initial mode is x. These modes 
axe supported: 

d print a short word in decimal 
X) print a long word in decimal 
o print a short word in octal 
O print a long word in octal 
x print a short word in hexadecimal 
x print a long word in hexadecimal 
b print a byte in octal 
c print a byte as a character 
s print a string of characters terminated by a null byte 
f print a single-precision real number 
F print a double-precision real number 

i print the machine instruction 
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valuer base 


value=base 

Converts a value to the specified base. 


Synopsis 

value=base 


Description 

Use the value=base command to convert the value you specify to the base you 
specify. The value can be a decimal, hexadecimal, or octal number. Precede hex¬ 
adecimal numbers with Ox; precede octal numbers with 0 (zero). The base can 
be D (decimal), X (hexadecimal), or O (octal). Prism prints the converted value 
in die command window. 

Examples 

OxlOO*D 

256 

256-X 

0x100 

0x100^0 

0400 

0400 S X 

0x100 
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alias 

Sets up an alias for a c omman d or a string. 


Synopsis 

alias 

alias new-name command 

alias new-name [ ( parameters) ] ■ string m 


Description 

Use the alias command to set up an alias for a command or a string. When 
commands are processed. Prism first checks to see if the word is an alias for 
either a c omman d or a string. If it is an alias, Prism treats the input as though the 
corresponding string (with values substituted for any parameters) had been 
entered. 

For example, to define an alias xr for the command rerun, issue die command: 
alias rr rerun 

To define an alias called b that sets a breakpoint at a particular line, you can issue 
the command: 

alias b(x) "stop at ac' 

You could then issue the command b ( 12 ) , which Prism expands to 
stop at 12 

Prism sets up some aliases for you automatically. Issue alias with no parame¬ 
ters to list the current set of aliases. 

Issue the unalias command to remove an alias. 
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assign 


assign 

Assigns the value of an expression to a variable or array. 


Synopsis 

assign Ival = expression 


Description 

Use riie assign command to assign the value of expression to ival. Ival can be 
any value that can go an the left-hand side of a statement in the language you are 
using — for example, a variable, a Fortran array section, or a C* left-indexed 
parallel variable. If Ival is a CM Fortran array or array section, the right-hand 
side must be a conformable expression. If Ival is a C* parallel variable, the right- 
hand side must be of the same shape. Prism performs the proper type coercions 
if the right-hand side does not have the same type as the left-hand side. 

Examples 

This example assigns the value 1 to x: 
assign x * 1 

If x is an array or a parallel variable, 1 is assigned to each element. 

This example adds 2 to each element of arrays and assigns these values to 
arrayl: 

assign arrayl * arrays + 2 

Note that arrays and arrayl must be conformable. 

This example assigns the value of element 4 of the C* parallel variable pvarS 
to element 7 of pvari: 

assign [6]pvari ■ [3]pvarS 
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attach 

Attaches to a running process. 


Synopsis 

attach pid 


Description 

Use the attach command to attach to the running process with process ID pid. 
To work on the process within Prism, you must have previously loaded the pro¬ 
cess’s executable program. 

Use the detach command to detach a process running within Prism. 
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call 


call 

Calls a procedure or function. 


Synopsis 

call procedure (parameters ) 


Description 

Use the call command to call the specified procedure or function at the current 
stopping point in the program. Prism executes the procedure as if the call to it 
had occurred from the current stopping point Breakpoints within the procedure 
are ignored, however. 

NOTE: If you call a C* function, you must pass parallel variables by reference, 
not by value. 
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catch 

Tells Prism to catch the specified UNIX si gnal. 


Synopsis 

catch [number j signal-name] 


Description 

Prism can catch UNIX signals before they are sent to the program. Use the catch 
command to tell Prism to catch the signal you specify. When Prism receives the 
signal, execution stops, and Prism prints a message. A subsequent cont from a 
naturally occurring signal that is caught causes the signal to be propagated to 
signal handlers in the program (if any); if there is no handler for the signal, the 
program terminates — in other words, the program proceeds as if Prism were not 
present. 

By default. Prism catches all signals except SIGHUP, SIGEMT, SIGK1LL, SI- 
GALRM, SIGTSTP, SIGCONT, SIGCHLD, and SIGWINCH; you can use the 
ignore command to add other signals to this list. 

Specify the signal by number or by name. Signal names are case-insensitive, and 
the SIG prefix is optional. 

Issue catch without an argument to list the si gnals that Prism is to catch. 
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cd 

cd 


Changes the current working directory. 


Synopsis 


cd [directory] 



Description 

Use the cd command to change your current working directory in Prism to direc¬ 
tory, with no arguments, cd makes your login directory die current working 
directory. 

The cd command is identical to its UNIX counterpart See your UNIX documen¬ 
tation for more information. 
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cmattach 

Attaches to a CM-2 or CM-200 resource. 


Synopsis 

cmattach [option...] 


Description 

Use the cmattach c ommand to attach to a Connection Machine resource and 
cold boot You are by default attached to the highest-numbered sequencer avail¬ 
able on the first CM available, whether it is timeshared or exclusive. 

Prism prints a message telling you the CM resource to which you are attached, 
or that no resource is available. 

The Prism version of cmattach accepts the following subset of the options 


available in the shell-level version: 

-e 

Attach in exclusive mode only. 

-t 

Attach in timeshared mode only. 

-c name 

Attach to the specified CM. 

-i number 

Attach via tire specified interface. 

-8 seq-set 

Attach to the specified sequencer or sequencer set 


NOTE: This command is available only if you are running Prism from a front end 
that is connected to a CM-2 or CM-200 series Connection Machine system. 
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cmcoldboot 


cmcoldboot 

Cold boots a CM-2 or CM-200 resource. 


Synopsis 

cmcoldboot [option ...] 


Description 

Use the cmcoldboot c ommand to cold boot the Connection Machine resource 
to which you are attached. Prism prints a message telling you that you have cold 
booted. 

The Prism version of cmcoldboot accepts all options accepted by the shell- 
level version of cmcoldboot. Namely: 

-h Print a help message. 

-g axis-length, axis-length ... 

Configure the CM to have the specified geometry. 

-b fraction Enter back-compatibility mode with the specified fraction of 
memory allocated for back-compatibility mode. 

-u ucode Load the specified version of the microcode. 

-v nprocs Enter back-compatibility mode and configure the CM to have the 
specified number of virtual processors. 


-x xdim -yydim 

Enter back-compatibility mode and configure the CM to have the 
specified numbers of processors arranged in a NEWS grid. 

You cannot redirect the output of this command. 

NOTE: This command is available only if you are running Prism from a front end 
that is connected to a CM-2 or CM-200 series Connection Machine system. 
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cmdetach 

Detaches from a CM-2 or CM-200 resource. 


Synopsis 

cmdetach 


Description 

Use the cmdetach command to detach from the Connection Machine resource 
to which you are attached. You can detach from the CM whether or not you at¬ 
tached from within Prism. Prism prints a message telling you that you have been 
detached. 

NOTE: This command is available only if you are running Prism from a front end 
that is connected to a CM-2 or CM-200 series Connection Machine system. 
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cmfinger 


cmfinger 

Displays information about CM-2 or CM-200 users. 


Synopsis 

cmfinger 


Description 

Use die cmfinger command to display information about the CMs to which 
your front end is connected and who is using them. 

You cannot redirect the output of this command. 

NOTE: This command is available only if you are running Prism from a front end 
that is connected to a CM-2 or CM-200 series Connection Machine system. 
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cmsetsafety 

Tunis safety on or off for a CM-2 or CM-200 resource. 


Synopsis 

cmsetsafety on | off 


Description 

Use the cmsetsafety on command to turn safety on for the Connection 
Machine resource to which you are attached; cmsetsafety off turns safety 
off. Issuing cmsetsafety also affects the setting of the toggle box in the 
CMsetsafety selection of the CM menu. 

Turn off safety when you are collecting performance data; otherwise, your re¬ 
sults will be inaccurate. If you attempt to run a program with collection and 
safety both on, Prism turns safety off and prints a message in forming you of this. 

NOTE: This command is available only if you are running Prism from a front end 
that is connected to a CM-2 or CM-200 series Connection Machine system. 
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collection 


collection 

Turns collection of performance statistics on or off. 


Synopsis 

collection [on |off] 


Description 

Use the collection on command to turn on collection of performance statis¬ 
tics. Use collection off to turn collection off. Issuing the command with the 
on or off argument also affects the setting of the toggle box in die Collection 
menu selection. 

Issue collection with no arguments to display the current status of collection. 
This is primarily useful in cammands-only Prism. 
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. . I .. I .... . . . ... | 

cont 

Continues execution. 


Synopsis 

cont [number | signal-name] 


Description 

Use the cont c ommand to continue execution of the process from the point 
where it stopped. If you specify a UNIX signal, by name or number, the process 
continues as though it received the signal. Otherwise, the process continues as 
though it had not been stopped. 

You can use the default alias c for this command. 
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core 


core 

Associates a care file with the loaded program. 


Synopsis 

core corefile 


Description 

Use the core command to associate the specified core file with the program cur¬ 
rently loaded in Prism. Prism reports the error that caused the core dump and sets 
the current line to the location at which the error occurred. You can then work 
with the program within Prism — for example, you can print the values of vari¬ 
ables. You cannot continue execution from the current line, however, and, if you 
were running fire pr og r am on a CM (for a CM-2 or CM-200) or on the nodes (for 
a CM-5), you cannot display the values of parallel variables or CM-resident 
arrays. 
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delete 

Removes one or more events from the event list 


Synopsis 

clelete all | ID [ZD...] 


Description 

Use the delete command to remove the events corresponding to the specified 
ID numbers. You obtain these numbers by issuing the show events c ommand. 
Use the all argument to delete all existing events. Deleting the events also re¬ 
moves them from the event list in the event table. 

You can use the default alias d far this command. 
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detach 

Detaches a process r unnin g within Prism. 


Synopsis 

detach 


Description 

Use the detach co mmand to detach the process that is currently running within 
Prism. The process continues to run in the background, but it is no longer under 
the control of Prism. 

Use the attach c ommand to attach to a r unning process. 
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display 

Displays the values of one or more variables or expressions. 


Synopsis 

[where ( expression ) ] display expression [, expression ...] 


Description 

Use the display command to display die value(s) of the specified variable(s) 
or expression(s). The display command prints the values immediately and 
creates a display event, so that the values axe updated automatically each time the 
program stops execution. 

The optional where expression provides a mask for die elements of the parallel 
variable or array being displayed. The mask can be any expression that evaluates 
to true or false for each element of the variable or array. Elements whose values 
evaluate to true are considered active', elements whose values evaluate to false 
are considered inactive . If values are displayed in the command window, values 
of inactive elements are not printed. If values are displayed graphically, the treat¬ 
ment of inactive elements depends on the type of representation you choose. 

In CM Fortran, the expression can operate on a conformable array. In C*, the 
expression can operate on a parallel variable that is of the same shape as the par¬ 
allel variable being displayed. 

Redirection of output to a window via the on window syntax works slightly dif¬ 
ferently for display (and print) from the way it works for other commands. 
If you don’t send output to the command window (the default), separate windows 
are created for each variable or expression that you display. Thus, the commands 

display x on dedicated 
display y on dedicated 

create two dedicated windows, one for each variable; each window is updated 
separately. 

Displaying to a window other than the command window creates a visualizer for 
the data. 
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display 


To display the contents of a register, precede the name of die register with a dol¬ 
lar sign. For example, 

display $pc on dedicated 

displays the contents of the program counter register. 

The SPARC registers are: 


$pc 

program counter 

$npc 

next program counter 

$£sr 

floating status register 

$fq 

floating queue 

$wim 

window invalid mask 

$tbr 

trap base register 

$g0-$g7 

global registers 

$i0-$i7 

input registers 

$10-$17 

local registers 

$00-$07 

output registers 

$sp 

stack pointer (synonym for $ 06 ) 

$£p 

frame pointer (synonym for $ 16 ) 

$£0-$£31 

floating-point registers 

$y 

Y register 


Examples 

display sum (£ 00 ) 

displays the sum of the elements of the array foo. 

where (foo .ne 0 ) display £00 on dedicated 
displays (in a dedicated window) the values of £00 that are greater than 3. 
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doc 

Displays on-line documentation in commands-only Prism. 


Synopsis 

doc 


Description 

Use the doc command to display on-line documentation in commands-only 
Prism. Issuing doc initially displays a menu of available documents. Choose the 
number associated with the document you want to see and press Return. If the 
document is made up of other documents (for example, chapters in a manual), 
another menu is displayed; once again, you can choose the number of the docu¬ 
ment you want to see. Otherwise, you see the first screenful of text in the 
document 

Use the syntax 

number 9 filename 

to redirect the text of the document associated with number to the file you spec¬ 
ify. Use 

number 99 filename 

to add the text to the end of an existing file. 

When tire first screenful of a document or a long mam is displayed, you will see 
a more? prompt at the bottom of your screen, "type y or simply press Return to 
see the next screen of text. Type n or q to return to the menu from which you 
came. 

Some documents list on-line manual pages that you may want to see. Enter m 
from a menu, followed by the name of any CMOST or UNIX manual page, to 
display the manual page. If you don’t enter the name, of a manual page, you will 
be prompted for it 

Enter p from a menu to return to the previous menu. 
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Eater q from a menu to leave the doc command and return to the (prism) 
prompt. 

NOTE: The doc command is not available in graphical Prism. Use the Online 
Doc selection from the Doc menu instead. 
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down 

Moves down the call stack. 


Synopsis 

down [count] 


Description 

Use the down command to move the current function down the call stack (that 
is, toward the current stopping point in the pro g r a m) count levels. If you omit 
count , the default is one leveL 

Issuing down repositions the source window at the new current function. 
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dump 

Prints the names and values of local variables. 


Synopsis 

dump [function |. ] 


Description 

Use the dump command to print the names and values of all the local variables 
in the function or procedure you specify. If you omit procedure. Prism uses the 
current function. If you specify a period (.), dump does a stack trace (like 
where), and prints die names and values of all local variables in the functions 
in the stack 
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edit 

Invokes an editor. 


Synopsis 

edit [filename \ procedure] 


Description 

Use the edit command to invoke an editor. With no arguments, the editor is 
invoked on the current file. If you speafy filename, it is invoked on that file. If 
you specify procedure , it is invoked on the file that contains that procedure or 
function; Prism positions you at the start of the procedure. 

The editor that is invoked depends on the setting of the Prism resource 
Prism.editor. If this resource is not set, Prism uses the setting of your editor 
environment variable. 

You cannot redirect the output of this command. 

You can use the default alias e for this command. 
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email 

Sends electronic mail about Prism 


Synopsis 

email 


Description 

Use the email command to send electronic mail about Prism to Thinking Ma¬ 
chines Corporation. The address to which the mail is sent is set when Prism is 
installed; it may be sent to your local applications engineer, or directly to Think¬ 
ing Machines’ customer support. 

When you issue the command. Prism invokes an editor. In the edit buffer are the 
last few Prism error messages you received (as a convenience in case you are 
reporting a bug), along with information about how to send the mail . The editor 
that Prism invokes depends on the setting of the Prism resource Prism.editor. 
If there is no setting. Prism uses the setting of your editor environment vari¬ 
able. 

You cannot redirect the output of this command. 
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file 

Changes the current source file. 


Synopsis 

file [filename] 


Description 

Use the file command to set die current source file to filename. If you do not 
specify a filename, file prints the name of the current source file. 

Changing the current file causes the new file to be displayed in die source win¬ 
dow. The scope pointer (-) in the line-number region moves to the current file 
to indicate the beginning of the new scope that Prism uses in identifying 
variables. 
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func 

Changes the current procedure or function. 


Synopsis 

func [function] 


Description 

Use die func command to set the current procedure or function to function. If 
you do not specify a procedure or function, func prints die name of the current 
function. 

Changing the current function causes the file containing it to be displayed in the 
source window; this file becomes the current file. The scope pointer (-) in the 
line-number region moves to the current function to indicate the beginning of the 
new scope that Prism uses in identifying variables. 
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help 

Gets help. 


Synopsis 

help [commands | release | command-name] 


Description 

Use the help c ommand to get help about Prism commands. 

Use the commands option to display a list of Prism commands. Specify a com¬ 
mand name to display reference information about that command. 

Use the release option to display the release notes for the version of Prism that 
you are running. 

Issuing help with no arguments displays a brief help message. 

You can use the default alias h for this command. 


36 


Version 1.2, March 1993 
Copyright © 1993 Thinking Machines Corporation 


Commands Reference 


hide 


hide 

Removes a pane from a split source window. 


Synopsis 

hide file-extension 


Description 

Use the hide command to remove one of the panes in a split source window. The 
pane that is removed contains the code specified by the file extension you supply 
as the argument to the command. 

Use the show command to create a split source window. 

Urn hide command is not meaningful in commands-only Prism. 

Examples 

To remove die pane containing the assembly code for the loaded program, issue 
this command: 

hide .s 

To remove the pane containing Fortran 77 source code, issue this command: 
hide .f 
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ignore 

Tells Prism to ignore the specified UNIX signal. 


Synopsis 

ignore [number | signal-name ] 


Description 

Prism can catch UNIX signals before they are sent to the program. Use die 
ignore command to tell Prism to ignore the specified signal. If the signal is 
ignored. Prism sends it to the program and allows the program to continue run¬ 
ning without interruption; the program can then do what it wants with the signal. 
By default. Prism catches all signals except SIGHUP, SIGEMT, SIGKILL, 
SIGALRM, SIGTSTP, SIGCONT, SIGCHLD, and SIGWINCH; you can use the 
catch command to catch these signals as well. 

Specify the signal by number or by name. Signal names are case-insensitive, and 
the SIG prefix is optional. 

Issue ignore with no arguments to list the signals that Prism ignores. 
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list 

Lists lines in the current source file. 


Synopsis 

list [source-line-number [, source-line-number] ] 
list procedure 


Description 

Use the list command to list lines in die current idle. The source widow is 
repositioned. The command also affects the scope that Prism uses for resolving 
names. 

With no arguments, list lists the next 10 lines from the current line. 

If you specify line numbers, the lines are listed from the first line number through 
die second. 

If you specify a procedure or function, list lists 10 lines starting with the first 
statement in the procedure or function. 

You can use the default alias 1 for this command. 
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load 

Loads an executable program into Prism. 


Synopsis 

load filename 


Description 

The load command loads the rile specified by pathname into Prism. The file 
must be an executable program compiled with die appropriate debugging switch 
and/or performance analysis switch (if you want to collect performance 
statistics). 

When you execute load, the name of the program appears in the Program field 
of the main Prism window, and die source code that contains the main function 
of die program is displayed in the source window. 

Use the reload command to reload die program currently loaded in Prism. 
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log 

Creates a log file. 


Synopsis 

log 9 filename 
log 99 filename 
log off 


Description 

Use the log command to create a log file, filename, of your commands and 
Prism ’s responses. 

Use the 99 form of the command to append the log to an already existing file. 
Use log off to turn off logging. 
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make 

Executes the make utility. 


Synopsis 

make [option...] 


Description 

Use the make command to execute the make utility to update and regenerate one 
or more programs. You can specify any arguments that are valid in the UNIX 
version of make. 

By default. Prism uses the standard UNIX make, /bin/make. You can change 
this by using the Customize utility or by changing the setting of the Prism re¬ 
source Prism .make. 

You cannot redirect the output of this command. 
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next 

Executes one or mare source lines, counting functions or procedures as single 
statements. 


Synopsis 

next [n] 


Description 

Use the next command to execute the next n source lines, stepping over proce¬ 
dures and functions. If you do not specify a number, next executes the next 
source line. 

You can use the default alias n for this command. 
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nexti 

Executes one or more machine instructions, stepping over procedure and function 
calls. 


Synopsis 

nexti [n] 


Description 

Use die nexti command to execute the next n machine instructions, stepping 
over procedures and functions. If you do not specify a number, nexti executes 
the next machine instruction. 
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perf 

Displays performance data. 


Synopsis 

perf 


Description 

Use the perf command to display an ASCII version of the performance data far 
a program. This typically produces a lot of output However, you can use the @ 
filename syntax to redirect the output to a file in the usual way. 

perf is actually an alias for performance statistics. 
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perfadvice 

Displays an analysis of performance data. 


Synopsis 

perfadvice 


Description 

Use the perfadvice command to display die output of Prism’s performance 
advisor, which provides an analysis of the performance data for a program. 
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perfload 

Loads a performance data file. 


Synopsis 

perf load filename 


Description 

j 

Use the perfload command to load the specified file containing performance 
data. If no program is loaded. Prism also loads the program for which the data 
has been saved. If another program is loaded. Prism asks if you want to load the 
program associated with the data; it loads the performance data in any case. If 
other performance data is already loaded, the new data overwrites it; you can 
load only one set of performance data at a time. 

Use the perf save command to save performance data to a file. 
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perfsave 

Saves performance data to a file. 


Synopsis 

per f save filename 


Description 

Use the perfsave command to save the current performance data to the file you 
specify. You can then reload the data into Prism via the perf load command. 
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print 

Prints the values of one or more variables or expressions. 


Synopsis 

[where ( expression ) ] print expression [, expression ...] 


Description 

Use the print command to print the values of the specified variable® or ex¬ 
pression®. 

The optional where expression provides a mask for the elements of the parallel 
variable or array being printed. The mask can be any expression that evaluates 
to true or false for each element of the variable or array. Elements whose values 
evaluate to true are considered active; elements whose values evaluate to false 
are considered inactive . If values are printed in die command window, values of 
inactive elements are not printed. If values are printed graphically, the treatment 
of inactive elements depends on the type of representation you choose. 

In CM Fortran, the expression can operate on a conformable array. In C*, the 
expression can operate an a parallel variable that is of the same shape as the par¬ 
allel variable being displayed. 

Redirection of output to a window via the on window syntax works slightly dif¬ 
ferently for print (and display) from die way it works for other commands. 
If you don’t send output to the command window (the default), separate windows 
are created for each variable or expression that you print. Thus, the commands 

print x on dedicated 
print y on dedicated 

create two dedicated windows, one for each variable; each is updated separately. 

Printing to a window other than the command window creates a visualizer for the 
data. 

To print the contents of a register, precede the name of the register with a dollar 
sign. For example, 

print $pc on dedicated 
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print 


prints the contents of the program counter register. 
The SPARC registers are: 


$pc 

program counter 

$npc 

next program counter 

$fsr 

floating status register 

$£q 

floating queue 

$wim 

window invalid mask 

$tbr 

trap base register 

$g0-$g7 

global registers 

$i0-$i7 

input registers 

$10-$17 

local registers 

$o0-$o7 

output registers 

$sp 

stack pointer (synonym for $ 06 ) 

$£p 

frame pointer (synonym for $16) 

$£0-$£31 

floating-point registers 

$y 

Y register 


You can use the default alias p for this command 

Examples 

print maxval(a) 

prints the maximum value of the array a. 

where (a > 3) print a on dedicated 
prints (in a dedicated window) the values of a that are greater than 3. 
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printenv 

Displays currently set environment variables. 


Synopsis 

pxintenv [variable] 


Description 

Use the printenv command to display the value of the specified environment 
variable. If you omit variable, the command prints the values of all environment 
variables that are currently set 

Prism’s printenv command is identical to its UNIX C shell counterpart. See 
your UNIX documentation for more information. 
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pushbutton 

Adds a Prism command to the tear-off region. 


Synopsis 

pushbutton label command. 


Description 


Use the pushbutton command to create a customized button in the tear-off 
gion. The button will have the label you specify; clicking on it will execute 
command you specify. The label must be a single word. The command can 
any valid Prism command, along with its arguments. 


To remove a button created via the pushbutton command, either enter tear-off 
mode and click on the button, or issue the untearof £ command, using “label” 
as its argument 


Changes you make to the tear-off region are saved when you leave Prism. 
This command is not available in commands-only Prism. 


Example 

This command creates a button labeled printfoo that executes the command 
print foo on dedicated: 

pushbutton printfoo print £00 on dedicated 
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pwd 

Displays the pathname of the current working directory. 


Synopsis 

pwd 


Description 

Use the pwd command to display the pathname of the current working directory 
in Prism. 

Prism’s pwd command is identical to its UNIX counterpart See your UNIX docu¬ 
mentation for more information. 
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quit 

Leaves Prism. 


Synopsis 

quit 


Description 

Issue the quit command to leave Prism. Note that, unlike its menu equivalent, 
quit does not ask you if you are sure you want to quit 


54 


Version 1.2, March 1993 
Copyright © 1993 Thinking Machines Corporation 





Commands Reference reload 


reload 

Reloads the currently loaded program. 


Synopsis 

reload 


Description 

Use die reload command to reload the program currendy loaded in Prism. 
Events you have associated with the program are lost 
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rerun 

Reruns the currently loaded program, using arguments previously passed to die 
program. 


Synopsis 

rerun [a/gs] [< filename ] [> filename ] 


Description 

Use the rerun command to execute the program currently loaded in Prism. If 
you do not specify args, rerun uses the argument list previously passed to the 
program. Otherwise, rerun is identical to the run command. You can specify 
any command-line arguments as args, and you can redirect input or output using 
< or > in the standard UNIX manner. 


56 


Version LZ, March 1993 
Copyright © 1993 Thinking Machines Corporation 


Commands Reference 


return 


return 

Steps out to the caller of the current function. 


Synopsis 

return [count] 


Description 

Use the return command to execute the current function, then return to its 
caller. If you specify an integer as an argument, return steps out the specified 
number of levels in the call stack. 

return is a synonym for stepout. 
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run 

Executes the currently loaded program. 


Synopsis 

run [args] [< filename ] [> filename ] 


Description 

Use the run command to execute the program currently loaded in Prism. Specify 
any command-line arguments as args. You can also redirect input or output using 
< or > in the standard UNIX manner. 

You can use the default alias r for this command. 
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select 

Chooses the master pane in a split source window. 


Synopsis 

select file-extension 


Description 

Use the select command to choose the “master pane” when the source window 
is split into mare than one pane. The master pane will contain the code with die 
file extension you specify as the argument to select. 

Prism interprets unqualified line numbers in commands in terms of the source 
code in the master pane. It also uses the master pane to determine the source code 
and language to use in displaying messages, events, performance data, the call 
stack, and so on. 

Scrolling through the master pane causes the slave pane to scroll to the corre¬ 
sponding location. You can scroll the slave pane independently, but this does not 
cause die master pane to scroll. 

In commands-only Prism, select determines the language that Prism uses in 
displaying messages, events, and so on. 

Examples 

select .s 

makes the pane containing the loaded program's assembly code the master pane, 
select .f 

selects the pane containing the Fortran 77 source code to be the master pane. 
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set 

Defines abbreviations and sets values for variables. 


Synopsis 

set variable = expression 


Description 

Use the set command to define other names (typically abbreviations) for vari¬ 
ables and expressions. The names you choose cannot conflict with names in die 
program loaded in Prism; they are expanded to the corresponding variable or 
expression within other commands. For example, if you issue this command: 

set x = variable_with_a_long_name 

then 

print x 
is equivalent to 

print variable_with_a_long_name 

The whatis, where is, and which commands know about variables you set via 
die set command. For example, issuing the command whatis x after issuing 
die set command above produces the response: 

user-set variable, x = variable_with_a_long_name 

In addition, you can use the set command to set the value of certain internal 
v ariables used by Prism. These variables begin with a $ so that they will not con¬ 
flict with die name s of user-set variables. You can change the settings of these 
internal variables: 

$d_precision, $f_precision — Use these variables to specify the default 
number of si gnificant digits Prism prints for doubles and floating-point variables, 
respectively. Prism’s defaults are 16 for doubles and 7 for floating-point vari¬ 
ables; this is die maximum precision for these variables. The value you set 
applies to printing in both the co mmand window and text visualizers. For 
example. 
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set $f_precision ■ 5 

causes Prism to print five significant digits for floating-point values. 

$ history — Prism stores the maximum number of lines in the history region 
in this variable. When the history region reaches the maximum. Prism starts 
throwing away the earliest lines in the history. The default number of lines in the 
history region is 10000. To specify an infinite length for the history region, use 
any negative number. For example: 

set $history ■ -1 

Prism uses up memory in maintaining a large history region. A smaller history 
region, therefore, may improve performance and prevent Prism from running out 
of memory. 

$fortran_string_length — Prism uses this value as the length of a charac¬ 
ter string when the length is not specified explicitly. The default is 10. 

$fortran_adjust_limit — Prism uses this value as the limit of a front-end 
or partition-manager adjustable array. The default is 10. 

$page_size — This value is used only in commands-only Prism. It specifies 
the number of output lines Prism displays before stopping and prompting with 
a more? message. Prism obtains its default from the size of your screen. If you 
specify 0, Prism never displays a more? message. 

$print_width — This value is used only in commands-only Prism. It specifies 
the number of items to be printed on a line. The default is 1. 

Issue the set command with no arguments to display your current settings. 

Issue the unset command to remove a setting. 
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setenv 

Displays or sets environment variables. 


Synopsis 

setenv [VARIABLE [ setting ] ] 


Description 

Use the setenv command to set an environment variable within Prism. With no 
arguments, setenv displays all current settings. 

Prism’s setenv command is identical to its UNIX C shell counterpart See your 
UNIX documentation far more information. 
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sh 

Passes a command line to the shell for execution. 


Synopsis 

sh [ command-line ] 


Description 

Use the sh command to execute a UNIX command line from a shell; the response 
is displayed in the history region. If you don’t specify a command line, Prism 
invokes an interactive shell in a separate window. The setting of your shell 
environment variable determines which shell is used. 

You cannot redirect the output of this command. 
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show 

Splits the source window to display the file with the specified extension. 


Synopsis 

show file-extension 


Description 

Use the show command to split the source window and display the assembly 
code, or the version of die source code with the specified extension, in the new 
pane. 

The show command is not meaningful in commands-only Prism. 

Use the hide command to cancel die display of the assembly code or source- 
code version, and return to a single source window. 

Examples 

To display die assembly code for the loaded program, issue this command: 
show .s 

If you have used CMAX to translate a Fortran 77 program into CM Fortran, and 
you have loaded the CM Fortran executable program, issue this command to dis¬ 
play the Fortran 77 source code: 

show .£ 

This assumes that a mapping file (with the name source-code. t tab) is available 
to provide die mapping between the CM Fortran and Fortran 77 sources. . 
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show events 

Prints out the event list 


Synopsis 

show events 


Description 

Use the show events command to print the event list The list includes an ID 
for each command; you use this ID when issuing the delete command to delete 
an event. 

You can use the default alias j for this command. 
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source 

Reads commands from a file. 


Synopsis 

source filename 


Description 

Use the source command to xead in and execute Prism commands from file¬ 
name. This is useful if, for example, you have redirected the output of a show 
events command to a file, thereby saving all events from a previous session. 

In the rile. Prism interprets lines beginning with # as comments. If \ is the final 
character an a line. Prism interprets it as a continuation character: 
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status 

Prints out the event list 


Synopsis 

status 


Description 

Use the status command to print the event list The list includes an ID far each 
command; you use this ID when issuing the delete command to delete an 
event 

status is an alias for the show events command. 

You can use the default alias j for this command. 
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Executes one or more source lines. 


Synopsis 

step [n] 


Description 

Use the step command to execute the next n source lines, stepping into proce¬ 
dures and functions. If you do not specify a number, step executes the next 
source line. 

You can use the default alias s for this command. 
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stepi 

Executes one or more machine instructions. 


Synopsis 

stepi [n] 


Description 

Use the stepi command to execute the next n machine instructions, stepping 
into procedures and functions. If you do not specify a number, step executes the 
next machine instruction. 
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stepout 

Steps out to the caller of the current function. 


Synopsis 

stepout [count] 


Description 

Use the stepout command to execute die current function, then return to its 
caller. If you specify an integer as an argument, stepout steps out the specified 
number of levels in the call stack. 

return is a synonym for stepout. 
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stop 

Sets a breakpoint. 


Synopsis 

stop [var | at line | in June] [if expression] [{ cmd ; cmd ...}] [after n] 


Description 

Use the stop command to set a breakpoint at which die program is to stop 
execution. You can abbreviate this command to st. 

The first option listed in the synopsis ( var | at addr | in June) must come first 
on die command line; you can specify die other options, if you include them, in 
any order. 

var is the name of a variable. Execution stops whatever die value of the variable 
changes. If the variable is an array or a parallel variable, execution stops when 
the value of any element changes. This form of the command slows execution 
considerably. You cannot specify both a variable and a location. 

at line stops execution when the specified line is reached. If the line is not in the 
current file, use the farm u JUename”:Une-number. 

in June stops execution when the specified procedure ar function is reached. 

if expression specifies the logical condition, if any, under which execution is to 
stop. The logical condition can be any expression that evaluates to true or false. 
Unless combined with die at line syntax, this form of stop slows execution 
considerably. 

[cmd} cmd ...} specifies the actions, if any, that are to accompany the break¬ 
point The actions can be Prism commands; if you include multiple commands, 
separate them with semicolons. 

after n specifies how many times a trigger condition (for example, reaching a 
program location) is to occur before die breakpoint occurs. The default is 1. If 
you specify both a condition and an after count Prism checks the condition first 
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stop In £oo {print a; where} after 10 

stops execution the tenth time in the function foo, prints a, and executes the 
where c ommand. 

stop at "bar":17 if a == 0 

stops execution at line 17 of file bar if a is equal to 0. 

stop a 

stops execution whenever the value of a changes. 

stop if a .eq. 5 after 3 
stops execution the third time a equals 5. 
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stopi 

Sets a breakpoint at a machine instruction. 


Synopsis 

stop! [var | at addr [ in June] [if expression] [ { cmd ; cmd ...}] [after n] 


Description 

Use the stopi command to set a breakpoint at a machine instruction. 

The first option listed in the synopsis (var | at addr | la June) must come first 
on the command line; you can specify the other options, if you include them, in 
any order. 

var is the name of a variable. Execution stops whenever the value of the variable 
changes. If the variable is an array or a parallel variable, execution stops when 
the value of any element changes. This form of the command slows execution 
considerably. You cannot specify both a variable and a location. 

at addr stops execution when the specified address is reached. 

in June stops execution when the specified procedure or function is reached. 

if expression specifies the logical condition, if any, under which execution is to 
stop. The logical condition can be any expression that evaluates to true or false. 
Unless combined with the at addr syntax, this form of stopi slows execution 
considerably. 

{cmd; cmd ...} specifies the actions, if any, that are to accompany the break¬ 
point The actions can be Prism commands; if you include multiple commands, 
separate them with semicolons. 

after n specifies how many times a trigger condition (for example, reaching a 
program location) is to occur before the breakpoint occurs. The default is 1. If 
you specify both a condition and an after count. Prism checks the condition first. 

Examples 

stop! at oxiooo 
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stops execution at address 1000 (hex). 

stopi at 0x500 if a == 0 
stops execution at address 500 (hex) if a is equal to 0. 
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tearoff 

Places a menu selection in the tear-off region. 


Synopsis 

tearoff "selection" 


Description 

Use the tearoff co mmand to add a menu selection to the tear-off region of the 
main Prism window. Put the selection name in quotation marks. Case and blank 
spaces don’t matter, and you can omit the three dots that indicate that choosing 
the selection displays a dialog box. If the selection name is available in more than 
one menu, put the name of the menu you want in parentheses after the selection 
name. 


Use the untearof f command to remove a menu selection from the tear-off 
region. 

Changes you make to the tear-off region are saved when you leave Prism. 

This command is not available in commands-only Prism. 

Examples 

tearoff "file" 

puts die File selection in the tear-off region, 
tearoff "print (events)" 

puts the Print selection from the Events menu in the tear-off region. 
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trace 

Traces program execution. 


Synopsis 

trace [vor | at line | in June] [if expression] [Icmdi cmd ...}] [after n] 


Description 

Use the trace command to print tracing information when the program is 
executed. In a trace. Prism prints a message in the command window when a 
program location is reached, a value changes, or a condition becomes true; it then 
continues execution. 

The first option listed in die synopsis <'year \ at line 1 in June) must come first on 
the command line; you can specify the other options, if you include them, in any 
order. 

var is the name of a variable. The value of the variable is displayed whenever it 
changes. If the variable is an array or a parallel variable, values are displayed if 
the value of any element changes. This form of the command slows execution 
considerably. You cannot specify both a variable and a location. 

at line-number specifies that the specified line is to be printed immediately prior 
to its execution. If the line is not in. the current file, use the form u 'filename":line- 
number. You can also specify a line number without the at; Prism will interpret 
it as a line number rather than a variable. 

in June causes tracing information to be printed only while executing inside the 
specified procedure or function. 

if expression specifies the logical condition, if any, under which tracing is to 
occur. The logical condition can be any expression that evaluates to true or false. 
Unless combined with the at line syntax, this farm of trace slows execution 
considerably. 

Icmdi cmd ...} specifies the actions, if any, that are to accompany die trace. Put 
the actions in braces. The actions can be Prism commands; if you include multi¬ 
ple commands, separate them with semicolons. 
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af ter n specifies how many times a trigger condition (for example, reaching a 
program location) is to occur before the trace occurs. The default is 1. If you 
specify both a condition and an after count. Prism checks the condition first 

When tracing source lines. Prism steps into procedure calls if they have source 
associated with them. It “next”s over them if they do not have source (for exam¬ 
ple, if they are run-time routines or CM Fortran procedures in files compiled with 
-nodebug). 


Examples 

trace {print a; where} 

does a trace, prints die value of a, and executes the where command at every 
source line. 

trace at 17 if a .gt. 10 
traces line 17 if a is greater than 10. 

trace 'bar*:20 
traces line 20 of file bar. 
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tracei 

Traces machine instructions. 


Synopsis 

trace! [var | at addr \ injunc] [if expression] [{cmd; cmd...}] [after n] 


Description 

Use the tracei command to trace machine instructions when the program is 
executed. 

The first option listed in the synopsis (var | at addr | in June) must come first on 
the command line; you can specify the other options, if you include them, in any 
order. 

var is the name of a variable. The value of the variable is displayed whenever it 
changes. If the variable is an array or a parallel variable, values are displayed if 
the value of any element changes. This form of the command slows execution 
considerably. You cannot specify both a variable and a location. 

at addr specifies that a message is to be printed immediately prior to die execu¬ 
tion of the specified address. 

in June causes tracing information to be printed only while executing inside the 
specified procedure or function. 

if expression specifies die logical condition, if any, under which tracing is to 
occur. The logical condition can be any expression that evaluates to true or false. 
Unless combined with the at addr syntax, this form of tracei slows execution 
considerably. 

{cmd; cmd ...} specifies the actions, if any, that are to accompany the trace. Put 
the actions in braces. The actions can be Prism commands; if you include multi¬ 
ple commands, separate them with semicolons. 

after n specifies how many times a trigger condition (for example, reaching a 
program location) is to occur before the trace occurs. The default is 1. If you 
specify both a condition and an after count. Prism checks the condition first 

When tracing instructions. Prism follows all procedure calls down. 
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Examples 

trace! 0x1000 after 3 

traces the instruction at address 1000 (hex) the third time it is reached, 
tracei 0x500 if a == 0 

traces the instruction at address 500 (hex) if a is equal to 0. 
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type 

Provides type information about Paris parallel variables, arrays, pointers, and 
structures. 


Synopsis 

type type variable 


Description 

Use the type command to tell Prism the type of a parallel variable, array, point¬ 
er, or structure in a Paris program. For example, if you define a variable of length 
32 and use it in Paris routines dealing with floats, you need to tell Prism that 
the variable represents a float.You must do this before you print the variable, 
array, pointer, or structure or use it in an expression. You only need to do it for 
variables, arrays, or structures that are allocated on the CM, and you only need 
to do it once per Prism session. 

Examples 

This example defines car to be a parallel unsigned int: 
type unsigned int caz 

This example defines bus to be a parallel stxuct of type vehicle: 
type struct vehicle bus 

This example defines train to be a parallel array of 20 ints: 
type int train [20] 

This example defines boat to be a pointer to a parallel int: 
type int *boat 
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unalias 

Removes an alias. 


Synopsis 

unaiias name 


Description 

Use the unaiias command to remove the alias with the specified name. Issue 
the alias command with no arguments to obtain a list of your current aliases. 
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unset 

Deletes a user-set name. 


Synopsis 

unset name 


Description 

Use the unset command to delete the setting associated with name. See the set 
command for a discussion of setting names far variables and expressions. 

Do not use the unset command to unset any of die Prism in ternal variables 
(beginning with $). 

Example 

If you use the set command to set this abbreviation for a variable name: 

set £red = £rederick_bartholomew 
You can unset it as follows: 
unset £red 

After issuing the unset command, you can no longer use fred as an abbrevi¬ 
ation for frederick bartholomew. 
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unsetenv 

Unsets an environment variable. 


Synopsis 

unsetenv variable 


Description 

Use the unsetenv command to remove the specified variable from the environ¬ 
ment 

Prism’s unsetenv command is identical to its UNIX C shell counterpart See 
your UNIX documentation far more information. 
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untearoff 

Removes a button from the tear-off region. 


Synopsis 

untearoff "label" 


Description 

Use the untearoff command to remove a button from the tear-off region of the 
main Prism window. Put the button's label in quotation marks. Case and blank 
spaces don’t matter, and you can omit the three dots that indicate that choosing 
the button displays a dialog box. If the tear-off region includes more than one 
button with the same label, include the name of the selection’s menu in paren¬ 
theses after the label 

Changes you make to the tear-off region are saved when you leave Prism 
This command is not available in commands-only Prism. 

Examples 

untearoff 'load* 

removes the Load button from the tear-off region, 
untearoff 'print (events)' 

removes die button that executes the Print selection in the Events menu. 
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up 

Moves up the call stack. 


Synopsis 

up [count] 


Description 

Use the up command to move the current function up the call stack (that is, away 
from, the current stopping point in the program toward the main procedure) count 
levels. If you omit count, the default is one level. 

Issuing up repositions the source window at die new current function. 
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use 

Adds a directory to the list of directories to be searched when looking for source 
files. 


Synopsis 

use [directory] 


Description 

Issue the use command to add directory to the list of directories Prism is to 
search when looking for source files. This is useful if you have moved a source 
file since compiling the program, or if for some other reason Prism can’t fmd the 
file. If you do not specify a directory, use prints the current list. 

No matter what the contents of the directory list is. Prism always searches first 
in the directory in which the program was compiled. 
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whatis 

Prints the declaration of a name. 


Synopsis 

whatis name 


Description 

Use the whatis command to display information known by Prism about a speci¬ 
fied name in the program. 

For CM arrays, the information printed includes [cm array]. For example: 
integer foo(l:65536)[CM array] 
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when 

Sets a breakpoint. The when command is comparable to the stop command. 


Synopsis 

when [var | at line | in June | stopped] [if expr] [{ cmd j cmd...}] [after n] 


Description 

Use the when command to set a breakpoint at which the program is to stop 
execution. 

The first option listed in the synopsis (var | at addr | in fane | stopped) must 
come first on the command line; you can specify the other options, if you include 
them, in any order. 

var is the name of a variable. Execution stops whenever the value of the variable 
changes. If the variable is an array or a parallel variable, execution stops when 
the value of any element changes. This form of the command slows execution 
considerably. You cannot specify both a variable and a location, as described be¬ 
low. 

at line-number stops execution when the specified line is reached. If the line is 
not in the current file, use the form u filename”:Une-number. 

in fane stops execution when the specified procedure or function is reached. 

stopped specifies that the actions associated with the command occur every 
time the program stops execution. 

if expr specifies the condition, if any, under which execution is to stop. This 
form of when slows execution considerably. The condition can be any expression 
that evaluates to true or false. Unless combined with the at line syntax, this form 
of where slows execution considerably. 

{cmd} cmd ...} specifies the actions, if any, that are to accompany the break¬ 
point. The actions can be any valid commands; if you include multiple 
commands, separate them with semicolons. 
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after n specifies how many times a location is to be reached before the break¬ 
point occurs. The default is 1. If you specify both a condition and an after count. 
Prism checks the condition first 

Example 

when stopped {print a on dedicated} 
prints the value of a in a dedicated window whenever execution stops. 
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where 

Shows the call stack. 


Synopsis 

where [count] 


Description 

Use the where command to print out a list of the active procedures and functions 
an the call stack. With no argument, where displays the entire list. If you specify 
count, where displays the specified number of functions. 

You can use the default alias t for this command. 
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whereis 

Prints the full qualification of all the symbols matching a given identifier. 


Synopsis 

whereis identifier 


Description 

Use the whereis command to display a list of the fully qualified names of all 
symbols whose name matches identifier. The symbol class (for example, proce - 
dure, variable) is also listed. 

Example 

Issuing this command: 
whereis x 

might produce this response: 

variable foo'x 
procedure fum'x 
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which 

Prints the folly qualified name of an identifier. 


Synopsis 

which identifier 


Description 

Use the which command to display die fully qualified name of identifier. This 
indicates which (of possibly several) variables or procedures by the name identi¬ 
fier Prism would use at this point in the program (for example, in an expression). 
The fully qualified name includes the filename or function name with which the 
identifier is associated. For more information on fully qualified names, see the 
Prism User’s Guide. 
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